home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / p_thenet / x1j.exe / USERGUID.TXT < prev   
Text File  |  1993-08-13  |  17KB  |  368 lines
  1.                        USER GUIDE FOR TheNet X-1J
  2.  
  3. This brief note is intended for users of TheNet X-1J, and explains the basic 
  4. commands. Configuration and sysop features are not covered fully.
  5.  
  6. TheNet  X-1J  is  an extension of TheNet 1, and provides  a  number  of  new 
  7. features.
  8.  
  9. The switch provides the following user commands :
  10.  
  11.           Connect
  12.           Info
  13.           Nodes
  14.           Routes
  15.           Users
  16.           Talk
  17.           CQ
  18.           BBS
  19.           Host
  20.           MHeard
  21.           Bye
  22.           DXcluster
  23.           IProute
  24.           ARP
  25.           QUIT
  26.  
  27. Not  all commands may be available on every node as certain  commands  might 
  28. have been disabled. If a command has been enabled, it will be displayed when 
  29. you  type  an  invalid command such as '?'. In   addition,  there  are  some 
  30. commands that are available but are not displayed. The main ones of interest 
  31. are :
  32.  
  33.           Links
  34.           Mode
  35.           Parms
  36.           Stats
  37.           IPAddress
  38.           DXCAlias
  39.           BBSAlias
  40.           HostAlias
  41.           MTU
  42.  
  43. In general, commands take parameters, for example to connect to GB7MXM, the
  44. command to be entered is CONNECT GB7MXM followed by return. Usually, 
  45. commands are not case sensitive ( although node aliases may be ), and
  46. commands may be abbreviated.
  47.  
  48. Connect
  49.  
  50.      If  the  connect command is given on its own, then  assuming  that  the 
  51.      sysop has set it up correctly, you will get connected to the local BBS.
  52.  
  53.      If you give another callsign, either of a local station or a node,  the 
  54.      node  will attempt to connect you to that station either by a  level  4 
  55.      connection  or  by downlinking. If you are downlinking,  you  may  also 
  56.      specify digipeaters.
  57.  
  58.      In either case, you get either a connected message or a message telling 
  59.      you  of the failure to connect. If you enter any other command at  this 
  60.      stage, the connection attempt will be aborted.
  61.  
  62.      If you attempt to downlink with digipeating, or attempt to downlink  to 
  63.      an  invalid callsign such as a node alias with an SSID, you may get  an 
  64.      error message depending on how the Sysop has configured the node.
  65.  
  66.      Finally,  if you connect to the node, then connect to another  station, 
  67.      and  that station disconnects you ( e.g. connect to a BBS and  use  the 
  68.      'Bye'  command of the BBS, you will either get reconnected to the  node 
  69.      or disconnected completely depending on the configuration of the node.
  70.  
  71.      If  you  enter a node alias and get an 'invalid call' message,  it  can 
  72.      either  be because the node is not recognised or it can be because  the 
  73.      Sysop has made node aliases case sensitive.
  74.  
  75. Info 
  76.  
  77.      This  command  gives information about the node as a combination  of  a 
  78.      message stored in the EPROM and a message entered by the Sysop.
  79.  
  80. Nodes
  81.  
  82.      This  command gives information about the distant nodes that this  node 
  83.      thinks  it  can  get  to. With no parameter, it  shows  the  alias  and 
  84.      callsign of all the nodes except those staring with a '#' character. If 
  85.      a parameter of '*' is given, those 'hidden' nodes will also be shown.
  86.  
  87.      If  a callsign or alias is given that the node does not know, it  gives 
  88.      an  error message. If the callsign or alias of a known node  is  given, 
  89.      the  node gives details of the routes it knows about that lead to  that 
  90.      destination.  The  display  shows one option per line,  each  of  which 
  91.      consists  of the path quality, obsolescence count and port followed  by 
  92.      the  callsign  of the neighbour. If any route is in use, a  chevron  is 
  93.      shown against the appropriate entry.
  94.  
  95.      If  so  configured  by the Sysop, 'Slime  trails'  i.e.  nodes  without 
  96.      aliases  that have not been the subject of a valid node broadcast,  may 
  97.      be omitted from the nodes list.
  98.  
  99. Routes
  100.  
  101.      This command gives information about the neighbouring nodes that can be 
  102.      heard.  For  each  neighbour, the display shows the  port  number,  the 
  103.      callsign,  the path quality and the number of nodes accessible  through 
  104.      this  neighbour. If a route has been 'locked' by the sysop, then a  '!'  
  105.      character  is shown after an entry. The sysop may have  configured  the 
  106.      node  to  display  nodes  as  callsign  or  as  alias:callsign.  If  so 
  107.      configured,  then if a node is shown as a callsign alone it means  that 
  108.      is  it  not currently reachable as its node broadcasts  are  not  being 
  109.      received.
  110.  
  111. Users
  112.  
  113.      This shows who is using the node. It does not show other nodes that are 
  114.      using  the  node as a level 3 relay, nor does it show those  users  who 
  115.      have connected to the node but otherwise have done nothing.
  116.  
  117.      The display shows the through connections, followed by those users  who 
  118.      are  connected to the switch and 'idle'. It also shows those users  who 
  119.      are  connected  to the conferencing facility. The latter  stations  are 
  120.      shown  connected to a destination called 'Talk', whilst in the case  of 
  121.      connections, the two endpoints are shown. For connections, two  symbols 
  122.      are  used,  '<-->'  and  '<..>'. The former  is  used  for  established 
  123.      connections   whilst   the  latter  is  used  for   connections   being 
  124.      established.
  125.  
  126. Talk
  127.  
  128.      The Talk command allows a group of users to hold a conference call.  It 
  129.      also  allows  a  user to send a message to another  user  of  the  node 
  130.      provided  that  user  is connected to the switch  but  is  not  patched 
  131.      through  to another station and is not currently trying to  connect  to 
  132.      another station.
  133.  
  134.      A user enters the conference by giving the command 'talk'. He/she  gets 
  135.      a message informing them of this and reminding them that the command to 
  136.      escape  from the talk command is '/exit'. Any other users currently  in 
  137.      the conference get a message from the node telling them of the callsign 
  138.      of  the user who has joined them. At this point, every line sent  by  a 
  139.      user in the conference is copied to all other users in the  conference, 
  140.      preceded by their callsign.
  141.  
  142.      To exit from the conference, the command '/exit' is used. This causes a 
  143.      response  message to be sent to the user, and at the same time  all  of 
  144.      those  left in the conference get a message from the node telling  them 
  145.      of the station who has left the conference. If you force a  disconnect, 
  146.      the other stations are not told of your departure.
  147.  
  148.      A  string of text may be entered on the same line as the  talk  command 
  149.      when  the  command  is  given. If this is  done,  before  the  user  is 
  150.      connected  to  the conference, that string of text is sent to  all  the 
  151.      other  users  of  the node who appear in the 'user' list  but  are  not 
  152.      connected to anything else. For example if GxABC were to type :
  153.  
  154.           TALK GyXYZ, Hello fred can I have a chat - type TALK
  155.  
  156.      then other users of the node ( including presumably Fred, would get the 
  157.      message :
  158.  
  159.           GxABC>> GyXYZ. Hello fred can I have a chat - type TALK
  160.  
  161.      on  their  screens. The only exception to this is that sysops  are  not 
  162.      sent the message.
  163.  
  164.      Note that the TALK command will pass 8 bit data if set to by the Sysop.
  165.  
  166. CQ
  167.  
  168.      This  command is used to broadcast a CQ message. In addition, the  fact 
  169.      that  you  are calling CQ is indicated in the USER list.  The  callsign 
  170.      will be your own with a different SSID, and anyone else can connect  to 
  171.      you by connecting to the callsign with the appropriate SSID.
  172.  
  173.      The CQ remains 'primed' for a while, and if any other command is  given 
  174.      to the node the CQ will be cancelled.
  175.  
  176. BBS
  177.  
  178.      When you issue the BBS command, assuming that the sysop has  configured 
  179.      it, you will be connected to the local BBS.
  180.  
  181.      If  you enter the command 'BBS ?', then the current setting of the  BBS 
  182.      will be displayed.
  183.  
  184. Host
  185.  
  186.      The  HOST command operates just like the BBS command. It may have  been 
  187.      disabled  by  the sysop, it may have been set to connect  to  the  same 
  188.      station as the BBS, or it may have been set to connect to another  host 
  189.      system.
  190.  
  191.      If you enter the command 'HOST ?', then the current setting of the HOST 
  192.      will be displayed. 
  193.  
  194. MHeard
  195.  
  196.      If  enabled,  the  heard list shows the last few  stations  heard.  The 
  197.      number  of entries is limited and set by the sysop so any stations  not 
  198.      heard  for  a  while may get pushed out of the list  by  others  heard. 
  199.      Assuming  that a station is not pushed out in this manner, the  display 
  200.      shows  the number of packets heard from that station since it  appeared 
  201.      in  the list and the time since it was last heard. The time  is  hours, 
  202.      minutes and seconds. The list also shows the port on which the  station 
  203.      was  heard ( port 0 is the radio port ), and if it hears IP  frames  or 
  204.      Net/Rom  frames,  it  adds a note to show that the station  is  a  node 
  205.      and/or a TCP/IP station.
  206.  
  207.      If the list is long enough so that a station is not heard for 12 hours, 
  208.      it will get deleted anyway.
  209.  
  210.      The  list  may  also show a column headed 'Dev.'.  This  will  only  be 
  211.      present  where the sysop has added to the node a small hardware  add-on 
  212.      that  measures the received signal audio level. Specifically, it  gives 
  213.      an  indication  of  the  peak  audio level.  By  means  of  a  software 
  214.      configuration  control and prior calibration, this gets converted  into 
  215.      an  indication of the transmitting station's signal deviation. It  does 
  216.      this by sampling the audio level after every valid packet.
  217.  
  218.      Care  must  be  taken  over its interpretation.  It  does  not  measure 
  219.      independently  the two tone levels - it is assumed that whatever  local 
  220.      standards that relate to pre-emphasis ( i.e. use it or not ) have  been 
  221.      implemented.
  222.  
  223.      Often, packet stations are set up, and the audio level tweaked until it 
  224.      appears to work reasonably error free. The idea of this add-on is that, 
  225.      having  done that, you then connect to the node and display  the  heard 
  226.      list to see an indication of your actual deviation. It may then be fine 
  227.      tuned to set it correctly. Local advice must be taken over the  correct 
  228.      setting as it depends on the channel spacing being used ( e.g. 12.5, 25 
  229.      or other KHz ).
  230.  
  231.      The meter will give the wrong answer on the following conditions :
  232.  
  233.           A badly distorted audio signal
  234.           Badly off frequency
  235.           Incorrect adherence to local pre-emphasis standards
  236.           A noisy signal
  237.  
  238.      If you connect, then correct your deviation to the correct display then 
  239.      find  performance  has  deteriorated, it indicates  one  of  the  above 
  240.      problems. It is not that the meter doesn't work, it is an indication of 
  241.      a fault elsewhere.
  242.  
  243.      It  is  in your own interest for those around you to  use  the  correct 
  244.      deviation. The list also allows you to see the deviation of others - so 
  245.      apply  peer pressure if someone over or under deviates. Remember it  is 
  246.      NOT  a  case of the higher or the lower the better - it is  having  the 
  247.      setting RIGHT.
  248.  
  249.      The system may also be used to migrate users towards a lower  deviation 
  250.      in advance of moving to narrower channel spacing.
  251.  
  252. Links
  253.  
  254.      The  LINKS command shows the level 2 connections to the node.  This  is 
  255.      usually  of  academic interest, but I use it in  testing.  The  display 
  256.      shows the links, one per line, with the two callsigns, the link  state, 
  257.      the port number and the current number of retries.
  258.  
  259. Mode
  260.  
  261.      The MODE command is a bit like the PARMS command. It shows a number  of 
  262.      additional parameters. These are as follows as shown by example :
  263.  
  264.           MODE
  265.           THENET:G8KBB-5> 0 1800 6 3 2 20 0 600 2 900 1 31 0 1 1 0 0
  266.  
  267.      with the following meanings :
  268.  
  269.      0     Host mode protocol ( 0 = standard, 1 = DCD mode )
  270.      1800  CWID period. Delay in seconds between CWID
  271.      6     CWID speed 10's of msec per dot. 6 equals 20 wpm
  272.      3     Enable / disable nodes broadcasts mask.
  273.      2     RS232 protocol, 0 = crosslink, 1,2 or 3 are KISS
  274.      20    TxDelay in 10's of milliseconds ( Centiseconds ?? )
  275.      0     Full duplex control. 0 equals simplex
  276.      600   RS232 port nodes broadcast interval in seconds
  277.      2     Nodes broadcast algorithm port mask
  278.      900   Beacon period in seconds
  279.      1     'connect' redirector. 0 is to HOST, 1 is to BBS
  280.      31    Each  bit controls one of the 'user' help messages, 8 bit TALK  & 
  281.            case sensitivity
  282.      0     This byte controls the broadcasting of 'hash' nodes
  283.      1     This byte enables / disables the extra alias operation
  284.      1     If set to '1', a remote disconnect on a circuit will cause a node 
  285.            reconnection
  286.      0     The  bits of this controls the operation of the node with  regard 
  287.            to 'slime trails'
  288.      0     The  bits of this control whether digi uplinks and downlinks  are 
  289.            permitted
  290.       
  291.      If  you  want  additional  details, ask the sysop for  a  copy  of  the 
  292.      overview guide.
  293.  
  294.  
  295. Parms
  296.  
  297.      This  shows the node parameters as per TheNet 1.01 ( I am not going  to 
  298.      list them again here. Sorry ).
  299.  
  300. Bye and Quit
  301.  
  302.      These commands disconnects you from the node, closing the link. It says 
  303.      goodbye  before disconnecting you if it has been so configured  by  the 
  304.      sysop. Quit does just the same as Bye does.
  305.  
  306. DXcluster
  307.  
  308.      If there is a local DXcluster, this command may have been configured by 
  309.      the sysop to connect you to it. It therefore operates in a manner  very 
  310.      similar to the BBS command.
  311.  
  312. Stats
  313.  
  314.      The  stats command gives lots of data about the node operation. A  full 
  315.      description of the information is contained in the overview document.
  316.  
  317. IProute
  318.  
  319.      This  command is used by the sysop to configure the IP route table.  It 
  320.      may also be used to display the router table.
  321.  
  322. Arp
  323.  
  324.      This  command  is  similar to the IProute command, but  shows  the  Arp 
  325.      table.  The  Arp  table  provides a  translation  from  Ip  address  to 
  326.      callsign.
  327.  
  328. IPaddress
  329.  
  330.      This command is used to set or display the current node IP address.
  331.  
  332. BBSAlias
  333. HostAlias
  334. DXCAlias
  335.  
  336.      These commands are used to set additional aliases for the node. It  can 
  337.      be  configured by the sysop to accept connect requests ( uplinks  )  to 
  338.      the  node  callsign, the node alias, or the 3 aliases  shown  by  these 
  339.      commands.  When the node accepts a connection to one of these  aliases, 
  340.      it  will immediately invoke the BBS, DXC or HOST commands for you.  The 
  341.      way this would normally be used is as follows. Suppose your local ( for 
  342.      example  )  BBS  was  not accessible on the  frequency  that  the  node 
  343.      operates  on.  The BBS alias can be configured to provide  easy  access 
  344.      across other nodes to the BBS. Hence in the case of the Ipswich  nodes, 
  345.      GB7MXM  does not have a port on 144.650, but the node IPS2  on  144.650 
  346.      can get to it by means of another node and a 9600 baud link. If IPS2 is 
  347.      set to accept the extra aliases, and if BBSAlias is set to MXMBBS, then 
  348.      anyone  who  tries  to uplink to MXMBBS in the Ipswich  area  would  be 
  349.      automatically  connected  to  GB7MXM. It goes without  saying  that  if 
  350.      GB7MXM had a port on 144.650 itself, then chaos would ensue. 
  351.  
  352. MTU
  353.  
  354.      This  command  allows  configuration  of the MTUs  for  IP  users.  The 
  355.      parameters have the following meanings :
  356.  
  357.      Parameter     Default        Controls
  358.      =============================================================
  359.           1        256       The MTU for the radio port, AX.25 encapsulation
  360.           2        256       The MTU for the RS232 port, AX.25 encapsulation
  361.           3        236       The MTU for the Net/Rom encapsulation
  362.           4        257       The max num. of data bytes in a recvd L2 frame
  363.           5        328       The max num of bytes in a received L2 frame
  364.  
  365.      For more details on the IP router, consult the 'overview' document.
  366.  
  367.  
  368.